home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / mint / mntdoc01.zoo / mintdoc / cat2 / fgetchar.nr < prev    next >
Encoding:
Text File  |  1993-03-03  |  1.7 KB  |  67 lines
  1.  
  2.  
  3.  
  4. Fgetchar(2)                Oct. 1, 1991               Fgetchar(2)
  5.  
  6.  
  7. N✓NA✓AM✓ME✓E
  8.        Fgetchar - read a character from a file
  9.  
  10. S✓SY✓YN✓NO✓OP✓PS✓SI✓IS✓S
  11.        LONG Fgetchar( WORD fh, WORD mode );
  12.  
  13. D✓DE✓ES✓SC✓CR✓RI✓IP✓PT✓TI✓IO✓ON✓N
  14.        _✓F_✓g_✓e_✓t_✓c_✓h_✓a_✓r reads a character from the open file whose handle
  15.        is _✓f_✓h.  The parameter _✓m_✓o_✓d_✓e has an effect only if the  open
  16.        file  is  a terminal or pseudo-terminal, in which case the
  17.        bits of _✓m_✓o_✓d_✓e have the following meanings:
  18.  
  19.        0x0001 Cooked mode; special control characters  (control-C
  20.               and  control-Z)  are checked for and interpreted if
  21.               found (they cause SIGINT and SIGTSTP, respectively,
  22.               to  be  raised);  also, flow control with control-S
  23.               and control-Q is activated.
  24.  
  25.        0x0002 Echo mode; characters read are echoed back  to  the
  26.               terminal.
  27.  
  28.        The  ASCII  value  of the character read is put in the low
  29.        byte of the long word that is returned. If the file  is  a
  30.        terminal  or pseudo-terminal, the scan code of the charac-
  31.        ter pressed and (possibly) the shift key status  are  also
  32.        returned  in  the  long word, just as with the BIOS _✓B_✓c_✓o_✓n_✓i_✓n
  33.        system call.
  34.  
  35. R✓RE✓ET✓TU✓UR✓RN✓NS✓S
  36.        The character read, if successful.
  37.  
  38.        0x0000FF1A if end of file is detected.
  39.  
  40.        EIHNDL if _✓f_✓h is not a valid handle for an open file.
  41.  
  42. S✓SE✓EE✓E A✓AL✓LS✓SO✓O
  43.        _✓B_✓c_✓o_✓n_✓i_✓n(2), _✓C_✓c_✓o_✓n_✓i_✓n(2), _✓C_✓a_✓u_✓x_✓i_✓n(2), _✓F_✓p_✓u_✓t_✓c_✓h_✓a_✓r(2), _✓F_✓r_✓e_✓a_✓d(2)
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64. Version 0.9          MiNT Programmer's Manual                   1
  65.  
  66.  
  67.